home *** CD-ROM | disk | FTP | other *** search
/ Mac Format 1994 October / Macformat17.cdr / Shareware City / Developers / PICTButton CDEF 1.0.7 / PICTButton README < prev    next >
Text File  |  1994-07-03  |  3KB  |  62 lines

  1. PICTButton CDEF version 1.0.7
  2. by Paul Celestin
  3. 3 July 1994
  4.  
  5. Copyright © 1994 by Celestin Company
  6. All Rights Reserved
  7.  
  8. PICTButton is a CDEF (control definition) that allows you to use pictures as buttons instead of the drab black and white buttons that you are used to. You can use it just about anywhere. I've tested it on various machines. I've included a sample application that shows the CDEF in action.
  9.  
  10. VERSION HISTORY
  11.  
  12. 1.0.7 - now works over multiple monitors of different bit depths
  13. 1.0.6 - removed unnecessary erasing code
  14. 1.0.5 - really fixed problem with black and white PICTs showing up properly
  15. 1.0.4 - changed color of text in variation 2 to blue
  16. 1.0.3 - fixed a problem with black and white PICTs showing up, or so I thought
  17. 1.0.2 - fixed the new variations
  18. 1.0.1 - added variations 1 and 2
  19. 1.0.0 - initial release
  20.  
  21. INSTRUCTIONS
  22.  
  23. To use the CDEF, copy the CDEF resource into your project's resource file. 
  24.  
  25. Then, create CNTLs with the following settings:
  26.  
  27. The BoundsRect should correspond to where you want to PICT to be displayed in your dialog.
  28.  
  29. Value should be the resource ID of the PICT you want as the default for the button. For example, you might use PICT ID 1000. In this case, the following table tells you what pictures you need and what they are used for:
  30.  
  31. 1000 - default color
  32. 1001 - inverted color (when you click and hold on the control)
  33. 1002 - default black and white (for when your monitor's bit depth is 1)
  34. 1003 - inverted black and white
  35.  
  36. Visible should be set to true.
  37.  
  38. Max and Min should be set to zero, since they don't mean anything to PICTButton.
  39.  
  40. ProcID should be set to (CDEF ID * 16) + Variation. I've set the CDEF ID to 36, so in most cases, the ProcID should be set to 576. There are two additional variations available. Variation 1 will display the title of the CNTL in the center of the PICT. Variation 2 will draw a two pixel wide line around the PICT. To use variation 1, set the ProcID to 577. To use variation 2, set the ProcID to 578.
  41.  
  42. RefCon should be set to zero.
  43.  
  44. Title can be set to anything you like. It will only be used if you use variation 1.
  45.  
  46. If you do not have a PICT of a certain ID and the CDEF is looking for it, things will probably not work correctly. If PICTButton does not work on your setup, I would certainly like to hear about it.
  47.  
  48. You may use PICTButton CDEF in any public domain, freeware, shareware, or commercial product. I would appreciate a copy of any product in which it is used. Credit would also be nice, though I don't require it.
  49.  
  50. Bugs, gripes, comments, etc. should be sent to me (Paul Celestin) at one of the following addresses:
  51.  
  52. Internet (preferred): celestin@pt.olympus.net
  53. AOL: Celestin
  54. CompuServe: 71630,650
  55. MCI Mail: 578-6464
  56.  
  57. Snail mail:
  58.  
  59. Paul Celestin
  60. Celestin Company
  61. 1152 Hastings Avenue
  62. Port Townsend, WA  98368